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ABSTB ACT 



An overview of the University of Utah Video-computer 
Courseware Implementation System (VCIS) programs is 

presented. A tutorial is included which is designed to 

provide an author with enough knowledge to create a simple 
lesson containing text and graphics frames. VCIS was used 
in creating two tutorials, which exercise most of the func- 
tions in the authoring system. One tutorial is only text 
and is an introduction to the Berkeley UNIX operating system 
and its vi editor. The other tutorial contains both text 
and graphics and is an introduction to Very Large Scale 
Integrated (VLSI) circuit design. An evaluation of the VCIS 
is also included. 
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I. INTRODUCTION 



The potential of computer-aided instruction (CAI) in 
today’s educational environment is great and is growing 
steadily. With the accessibility of personal computers, the 
use of computer-aided instruction becomes an even more 
attractive option for the instructor. 

In the area of VLSI design, the use of computer-aided 
instruction is particularly worthwhile due to the increasing 
use of computer-aided design (CAD) tools. The material in 
the lessons themselves is ideally suited to the CAI environ- 
ment, because in VLSI design part of the initial familiari- 
zation process is recognizing the shapes and colors as they 
are presented on a computer monitor screen. Also, use of 
these tools requires a considerable amount of orientation 
before the student is able to use them for design. The 
classroom environment is not ideal for teaching use of CAD 
tools. This orientation would be best, of course, if it 
could be done individually with one-on-one instruction 
involving the professor and the student, but even with small 
classes of students, this ideal situation is rarely 
possible. A well constructed lesson using CAI can be nearly 
as effective as individual instruction. It allows the 
student to proceed at his/her own pace and at a time that is 
convenient for him/her. It frees the professor to answer 
more questions from the rest of the students. 

Attractive though this option is, there can be difficul- 
ties in developing a lesson that will function in this envi- 
ronment. In any environment, of course, the instructor must 
be able to present the lesson material ir. a clear and 
concise format, but in a computer environment, this becomes 
even more critical. Not only is the instructor generally 
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not present to answer questions on the lesson material, but 
the man-machine interface can add to student frustration. 

The lesson or tutorial must be both useful to the 
student, and possible for the professor to develop in a 
reasonable amount of time. Rather than attempting to 
combine text-editing programs and graphics production 
programs, and then finally having to develop a program to 
control the lesson structure, there are CAI authoring 
systems to lessen the arduous task of lesson production 
without use of such a system. 

The interest in CAI has been growing at the Naval 
Postgraduate School, for use in explaining CAD tools, as 
well as in other areas. After considering various authoring 
systems, in March, 1984 NPS received copies of the 
Video/computer Courseware Implementation System (VCIS) 
produced by the University of Utah Research Foundation. 
VCIS possesses programs which enable the author to produce 
text and graphics frames, and select videodisk or videotape 
frames. VCIS also provides the programs to build the lesson 
from these component parts. Once finished with constructing 
the lesson, the authoring system can be used to test, 
execute, and print the tutorial. Two tutorials, which 
together exercise most of the functions of the authoring 
system, were created using the VCIS. 

An overview of the VCIS programs currently available is 
provided in Chapter II. Chapter III is a tutorial cn the 
VCIS, which is intended to enable an author to create a 
simple lesson. Chapter IV describes the two tutorials 
produced using the VCIS and Chapter V evaluates the VCIS. 
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II. THE V IDE O- COMPUTER COURSEWARE IMPLEMENTATION SYS TEM 

(VCIS) 



A. HARDWARE 

The University of Utah Video-computer Courseware 
Implementation System can be used on a variety of micro- or 
mini- computers under several operating systems. The micro- 
computers currently supported are Sirius, Terak 8510a, 
Zenith Z-100, IBM PC or XT and true IBM compatibles, Sperry 
Univac micro, and HP 9836. Current efforts are underway 
involving the Tandy 2000 and the Macintosh. The VAX 11-750 
and the VAX 11-780 are also supported. VCIS runs under four 
operating systems at present: Microsoft DOS Version 2.0 and 
later, Berkeley UNIX 4.2, UCSD Pascal, and HP Pascal. 

Each one of the microcomputers listed in the previous 
section needs 256K of memory to run VCIS. The combination 
of a hard disk and one or more disk drives makes file manip- 
ulation easier but is not necessary. 

An actual VCIS workstation consists of a microcomputer, 
or a graphics terminal, connected to a minicomputer with a 
videodisc or videotape player under computer control. The 
station has either a 9" or 13" black and white or color 
monitor or TV. If the microcomputer is ar. IBM PC, its color 
capabilities may be augmented by use of the Tecmar Graphic 
Master color board, or the regular IBM board may be used. 

B. PROGRAMS 

1 . Intr oduc tion 



The programs are as described in VCIS User's Guide 
2.0d and 3.0a. See [Refs. 1,2] for complete descriptions of 



the commands. The following sections provide a brief over- 
view of the programs and use capitalized words to indicate 
use of a VCIS command. 

2. TEXTEDIT 

a. Capabilities 

TEXTEDIT is the program used to create the text 
portion of a lesson. Lesson text can be composed of up to 
254 segments with up to 254 frames per segment. A text 
frame is a grid of 23 (vertical) by 80 (horizontal) char- 
acter positions. The 24th line of the frame is the command 
line. A frame is comparable tc a transparency which may be 
overlaid with another text or graphics frame. If the frames 
are properly constructed, the underlying frame or frames 
will remain visible. 

The number of colors available for background 
and foreground depends on the system. Eight background 
colors and 16 foreground colors are supported. On systems 
without color, the background color is usually ignored and 
the foreground colors are sometimes displayed with varying 
intensities. The background color is not saved as part of 
the text file, however, and has to be re-specified later in 
BUILDER. 

There are two complete 96 character sets avail- 
able with most systems (one with and one without under- 
lines). Another program, CHEDIT, provides the capability to 
create additional character sets (one using Greek letters, 
for example). There are 255 possible text attributes (type 
of character, color of foreground, color of background) from 
which to form the working group used for a lesson. 
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b 



Text Entering or Changing 



Text is entered initially with the INSERT 
command. When the insertion is complete, it is <ACCE?T>ed 
or removed if undesirable with <ESC>. After text has been 
entered, it can be MOVEd or EELETZd or changed to a NEW 
color or character set. As the text is entered or changed, 
the author must remember the difference between a space 
{using the spacebar) and a null-space (using the cursor) . 
Frames are like transparencies and a space appears as a bit 
of background color. Several frames can be merged together 
to create a new frame, again using the concept of frame 
transparency . 

At any time during the text creation, the author 
can VIEW any or ail earlier frames or any graphics frame. 
This feature makes it easy for the author to see how the 
text' and graphics frames combine together, as well as how 
the text alone is progressing. 

3 . GRAFED IT 



modify the 
GRAFEDIT is divided 
may contain up to 
graphics frame depen 
monitor . 

Eight to 

the system used. A 
of several options 
(fill small area) , 
become the working s 
altered at any time 
set, following the completion 



create and 
th TEXTEDIT, 
each segment 
size of the 
e individual 

are available depending upon 
color may be selected for each 
(fill large area), LINE, FILL 
BACKGROUND. These selections 
working set may be temporarily 
revert to the original working 
of that particular command. 



a. Capabilities 

GRAFEDIT is the program used to 
graphics segments of lessons. As wi 
into 254 segments, where 
254 frames. The actual 
ds on the resolution of th 



16 colors 
different 
- ZONE 
MARKER or 
et. The 
and will 



There are up to nine pattern indices available. 
They range from solid through diagonal, vertical and hori- 
zontal lines to dots to a blinking pattern. The programmer 
has the option to change the kind of pattern available. The 
size of the elements within the pattern does not change as 
an object is increased or decreased in size. 

b. Object Creation/Modification 

The basic unit of the graphics frame is the 
object. It can be created using one of the seven predefined 
graphics objects {line, circle, arc, bezier curve, marker, 
fill or zone) or using other author defined objects. The 
object is created by moving the cursor to any point on the 
screen using a digitizer, keyboard or mouse. An object 
consists of groups of control points (a circle has two 
control points - the center and a point on the circle) . A 
grouping starts when the first control point is entered and 
it ends when another option (LINE, ZONE, etc.) is chosen. 
The object can be modified at any time to any degree. The 
author also can use objects created on other frames, 
segments or files to create a n ew frame or object. As with 
TEXTEDIT, the author can overlay the current graphics frame 
with any text frame. 

4 . BOIL DEK 

BUILDER creates the actual lesson structure. This 
program orders the presentation of the text, graphics, and 
video frames previously created. It sets up the question 
patterns - what answers are allowed or anticipated (right or 
wrong) , in addition to responses for unanticipated answers. 

BUILDER segments are composed of video, graphics and 
text frames and may be of any length, subject only to the 
amount of available room on the disk. A segment may call or 
USE other segments. It may also call a large "special" (up 
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to 10K words of code) or a small "special" (up to 6K words 
of code) . "Specials" are Pascal programs written to add 
features not supported by 7CIS. A special would be used to 
create a graph from a student's input, for example. 

A lesson segment is created by setting up various 
paths for a student to follow. Each decision point has 
various options available to the author. The student way 
continue directly, branch to a help segment, back up to view 
previous frames, or quit. The author must have planned all 
options, as unfinished paths are not allowed. 

5 . INTEEP 

The lesson segments can be tested, or used in their 
final form, by using INTEEP. INTERP uses the options speci- 
fied in MANAGER to decide, for example, if student path and 
answers are to be recorded, or if backing up is allowed. If 
other segments are called (USEd) during a test run, INTERP 
will assume the segment was available and was properly 
executed, and it will continue. For testing purposes, 
INTEEP requires the four files per segment created by 
BUILDER (.GRAF, .RUN, .PAG and .TXT). In the testing mode, 
INTERP provides tracing information on the monitor which 
shows the segment and question that is currently being used. 
When the lesson is completed and INTEEP is in the final 
mode, the file MANAGER.DAT must be present. In the testing 
mode, INTEEP uses only those commands written by BUILDER, 
but other options must be selected for the final run that 
MANAGER.DAT provides (options like allowing backing up or 
recording student path). 

6 . MANAGER 

MANAGER is the program that creates the file 
MANAGER.DAT used by INTEEP. It also creates the list cf 
students who are allowed to access the lesson if passwords 
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are to be used. MANAGER holds the list of right, wrong and 

neutral replies used by INTEEP when a random reply is 
needed. Student paths and answers are recorded in 
MANAGES. DAT for future reference. 

7 . Other P rog rams 

a. LISTFRAM 

LISTFRAM lists text or graphics frames. Output 
may be to the monitor or to a printer. A partial or a 
complete listing of text or graphics frames is allowed. 

b. CHEDIT 

CHEDIT creates or edits character sets. A 
regular size grid (10 dots high by 8 dots wide) and a wide 

size grid (10 dots high by 16 dcts wide) are available. The 
regular size grid creates a character set of 192 possible 
characters, while the wide size grid has a set of 96 
characters . 



c. LINKER 

The LINKER programs links one control segment 
with up to 8 additional segments. If a lesson has more than 
eight segments, LINKER can be used as many times as needed 
doing no more than eight new segments at a time. If one 
segment has been changed, the whole lesson does not need to 
be relinked. Only the new segment must be relinked to the 
old lesson, where it will replace the older version. 

d. SCOMPARE 

SCOMPARE provides the facility of checking 
possible string combinations as used in BDILDER. This 
allows the author to see if wrong and right answers will be 
properly detected when entered ty the student. 
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e. SELECT 



SELECT picks the video sequences for a lesson. 
The author uses SELECT to obtain the start and stop points 
of the sequence for later use in BUILDER. 

C. CONCLUSIONS 

Kith the basic VCIS workstation containing a micro- or 
mini-computer with a graphics terminal and an overview of 
the functions available under the authoring system, the next 
step is to create a CAI lesson at the workstation using the 
programs. Chapter III provides a tutorial which if used 
with the VCIS User’s Manuals, will assist the author in 
creating a simple lesson using text and graphics. 
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III. DSING VCIS 



A. INTRODUCTION 

This chapter is intended to provide a basic knowledge of 
VCIS. Upon completion, the reader should be able to create 
a simple lesson with basic text, standard (system) character 
set and simple graphics. Explanations for all of the 
commands for a given program or all the options within a 
given command are not provided. See [Refs. 1,2] for further 
details and explanations. The convention used here is that 
program names are completely capitalized, while command 
names within a program have only the first letter capital- 
ized and are enclosed in quotation marks. Specific terminal 
keys are indicated by completely capitalizing the name of 
the key and by enclosing the name in "<>". 

The explanations are given in terms of an IBM PC with a 
Tecmar Graphic Master color board, however, usage on other 
computers is similar. While VCIS permits use of the mouse, 
digitizer, or keyboard for command input, only the keyboard 
commands are given . 

The programs are presented in the sequence that the 
author would probably use in creating a lesson, except for 
TEXTEDIT and GRAFEDIT which are interchangeable. The 
sequence is TEXTEDIT, GRAFEDIT, BUILDER, INTER?, LINKER, 
MANAGER, and LISTFRAM. 

B. LESSON PLANNING 

Before attempting to use any of the VCIS programs, the 
author must determine the lessen structure. Lesson struc- 
ture starts with the overall structure - whether the lesson 
will be menu-driven or will be strictly sequential, for 
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example. Lesson structure also includes the structure of 
the frame - if the frame is purely factual, or if the 
student is asked a question on lesson material. 

VCIS allows the author tc ask questions of various 
types. For example, the author may ask questions which 
require the student to do a numerical calculation, provide a 
string response or make a choice among author-supplied 
responses. In each instance, the author must determine a 
response to the three types of possible student answers, 
which are right, wrong or unanticipated. Each anticipated 
right or wrong answer may have its own response. 

The text and graphics on each frame have to be edited to 
provide a clear and concise presentation of a minimum number 
of new ideas. Especially when both text and graphics are 
used, the author must take care to avoid a cluttered and 
crowded screen. While the lessen can be structured to allow 
the student to back-up and review a previous frame, careful 
editing of each frame will minimize this. A clear presenta- 
tion with unambiguous questions will minimize the number of 
wrong and unanticipated answers. 

C. SETTING OP AND PROGRAM CONVENTIONS 

The system is booted up using the Microsoft DOS V2.0, 
with a system file that structures the use of the F7, F8 , 
F9, and F10 function keys for use as cursor control keys 
(up, down, left, and right, respectively). Once booted, all 
of the programs described (except MANAGER) will return the 
author to the operating system upon completion. See 
Appendix C for details on what disks are needed and on the 
logon procedure. 

Except where indicated, the author invokes a command 
only by typing the first letter (which is capitalized) of 
the command. No additional ENTER or RETURN keystroke is 



required. A command is usually terminated with either the 
<DEL> (accepts the action of the command) or the <ESC> 
(usually aborts the action of the command) . 

D. TEXTEDIT 

1 . Initial Step s 

Before invoking the TEXTEDIT program, the author 
should be sure that there is sufficient room on the diskette 
to save the file and its changes. This is done by using the 
Microsoft Dos command "dir<RET>". If no drive is specified, 
the default (shown by the prompt "A>" or "B>") is used. The 
directory of the other drive is checked, without changing 
drives, by "dir b:<RET>", or "dir a:<RET>". The directory 
displays files with their sizes, the date the files were 
last changed, the total amount cf space used, and the amount 
of space remaining on the diskette. TEXTEDIT itself 
requires 118K bytes of space, while a sample file containing 
one segment with 68 frames, needs 6 4K bytes. 

TEXTEDIT is invoked by typing TEXTEDITS ET> . The 
first level command line (line 24 ) displays: 



Create Edit List j 



"Create" sets up a new text file, while "Edit" 
changing or adding to a previously created 
"List" is used to list the files on the disk. 
"Create" requires a segment name. Segment n 
clearly indicate their position and/or functi 
lesson. The filename is specified at the 
session. A new segment starts with frame number 
asks for the filename and when obtained (the fil 
on a disk in the other drive, for example) 



is used for 
text file. 
If selected, 
am e s s ho ul d 
on within a 
end of the 
1. "Edit" 
e may reside 
, TEXTEDIT 
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displays information on the file and asks if the author 
wants to start a new segment. The information displayed is 
the number of segments in the file, the number of times a 
segment has been revised and the size of the segment in 
frames and blocks. The author decides whether to start a 
new segment by answering Y (Yes) or N (No). A positive 
response elicits a reguest for the new segment name while a 
negative response causes the system to ask for a current 
segment name. As in "Create", a new segment starts with 
frame number 1. A previously created segment starts with a 
new frame with the next number (for example, if 31 previous 
frames exist, the next frame is 32) . 

The command line for "List" displays: 



i 1 

All Directory Font Graphics Eattern Text Remove | 

i i 

The commands "All", "Font", "Text", and "Graphics" list 
those files of the types specified that reside cn the disk. 
"Directory" provides the author with the opportunity to 

change the directory name. "Eattern" attempts to match a 
pattern string against file names on the disk. 

2 • Creatin g A F rame 

a. Set Up 

Once the new frame appears, the second level 
command line is: 



1 

Delete Yank Xchange New -- 


Adjust Move ? 


1 

<-> 


Keep 


Edit 


Copy Remove View 


-- Page Graphics ? 


A 

• 

V 


Undo 


Find 


Status "List" — 


Move Tab — Quit 


•0 

A 

• 

V 
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As shown, the second level command line appears as three 
lines, and the author cycles from one line to the next by 
use of the period <.> key. It is not necessary for a 
desired command to be visible on the command line for it to 
be invoked. A one line summary of commands is provided 
with <?>. 

TEXTEDIT is initialized with certain default 
values which are shown in Figure 3.1 and Figure 3.2. Ihe 
character set, or font, is the one provided by the system, 
which is similar to most typewriter keyboards (no mathemat- 
ical symbols, for example) . The default attributes are 
blue, red, purple/pink, light green, light blue, yellow and 

white foreground colors with black highlighting. The frame 

background is black. 

These default values can be changed at any point 
during the text editing process. The author can view or 
change the default values by invoking "Status' 1 (type "S") . 
The first screen of "Status" (Figure 3. 1) has the command 
line : 

i n 

Segment_name Font Background Edit List Quit 
i I 



"Segment_name" allows the author to change the current 
segment name. "Font" allows the author to name a new char- 
acter set other than the standard set which is listed as the 
default. The character set file must be available, either 
on the same disk or on the hard disk, or an error will 
occur. "Background" prompts the author for the frame's 
background color (0-7) when invoked. The background color 
is not saved with the text frame and must be respecified 
later, when the text frame is used in BUILDER. "Edit" 
displays the total set of 255 attributes available (Figure 
3.2). The default values are indicated by asterisks. These 
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Figure 3.1 TEXTEDIT Status Screen 1 

attributes have the normal character set (no underlining) in 
the upper half of the total set, witn the alternate char- 
acter set (with underlining) in the bottom half. Each 
attribute is displayed as a number with one of eight back- 
ground colors and one of 16 foreground colors. "List" 
displays the same information about the current text file as 
would be displayed when TEXTEDIT was first entered. 

On the second screen of "Status", the cursor is 
homed on the first attribute in the upper left corner of the 
attribute matrix. An attribute is selected or removed from 
the working set by moving the cursor to the desired position 
with the function keys F7-F10 and depressing <DEL> to accept 
or remove that attribute. This new working set is not saved 
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Figure 3.2 TEXTEDIT Status Screen 2 

with the text frame, and must be regenerated each time the 
file is edited. The author stops the attribute editing 
session with "Quit", which returns to the "Status" screen 
one, and an additional "Quit" is needed to return to the 
second level command line. 

b. Putting Text on the Screen 

The author selects the desired attribute for 
text input by cycling through the working set by holding 
down the <CONTEOL> and G keys simultaneously. The second 
level command line then displays the current attribute. 
Text is placed on the screen by invoking "Insert" and typing 
in the text. The author must either type <RET> or 
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re-position the cursor at the end of each line as the text 
does not wraparound around the screen. There will be a beep 
(prompt) if the author attempts to put text past the end of 
a line. The author can put text at different places on the 
screen by moving about with either the function keys, or a 
combination of <SPACE BAR> and <RET> . 

The effects of the function keys and that of the 
<SPACE BAR> are entirely different. The function keys 
produce a null space, while the <SPACE B AR> yields a space 
made in the background color. This is important only when 
one frame overlays another, when what appears to be an empty 
area on the top frame is actually an opaque screen. The 
best way to avoid any difficulties, is to use the cursor 
position keys when moving the cursor from one part of the 
screen tc another. Frequent use of "View" will check or. any 
unwanted opaque areas. 

At any point during the insertion, the author 
may change attributes, by again cycling through tne working 
set using <CONTROL> and G. This only affects future text 
and not that already placed on the frame. Mistakes can be 
corrected by either backspacing (erases the text) or posi- 
tioning the cursor with the function keys, and inserting the 
new/correct text or characters. The "Insert" command ends 
with <DE1> (to save) and <ESC> (to destroy) changes. 

c. Viewing Other Frames 

When text and graphics will be combined later on 
the same lesson frame, the author must make frequent compar- 
isons between the current text frame and its associated 
graphics frame or frames. The TEXTEDIT command "Graphics" 
starts by requesting the file name, then the segment name 
(only if there is more than one segment) . Once the graphics 
file has been specified, the same file will be used if the 
"Graphics" command is again invoked, unless a different file 
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is requested. Once the graphics file and segment names are 
known, the "Graphics" command line is: 



i 1 

Get Segment Clear Frame Next Previous <ACC3?T> <ESC> 

i I 

"Get" changes the graphics file specified when "Graphics" 
was first invoked. "Segment" changes the segment used in 
the "Graphics" command. "Clear" erases all graphics frames. 
"Frame" asks for a frame number and overlays that frame on 
the current text frame. "Next" and "Previous" overlay the 
next and preceding frames on the screen, providing that a 
frame number has already been specified. The specified 
graphics frames are kept on the screen with the <DEL> key. 
This also returns the author to the second level command 
line. Once accepted (<DEL> key), the displayed graphics 
frame or frames remain with the frame, until a "Remove" 
command is issued or until a new text frame is displayed 
(for example, use of "Insert" creates a new text frame) . 
<ESC> also returns the author to the second level command 
line, but the graphics frame or frames are cleared from the 
frame. 

The author can check for consistency of the 
position of the material on a line (useful for command 
lines) or wording of text, or can merge frames by using the 
"View" command. "View" produces the command line; 



i ! 1 

(segment name} Segment Frame Next Previous Clear <ESC> 
<ACCEPT> 

1 



Initially, the current segment name is displayed on the 
command line. This may be changed with the command 
"Segment". "Frame" requests the frame number within the 
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named segment to be overlayed on the current text frame. 
"Frame" and "Segment" prompt the author for a number and a 
name, respectively. "Next" and "Previous" display the next 
and preceding frames if a frame number has been selected 
earlier. "Clear" removes the overlayed frame. <ACCEPT> 
(the <DEL> key) merges the overlaid text frame or frames 
with the current frame, and returns the author to the second 
level command line. <ESC> also returns to the second level 
command line with the viewed frame or frames remaining on 
the screen, but without merging them with the current frame. 

d. Ending the Frame and the File 

When a text frame is completed, "Keep" is 

invoked. It is not possible tc progress to the next frame 
unless the current frame has been kept. When a frame has 
been kept, TEXTEDIT cycles to the next frame, and the text 
creation process repeats. 

When the author types "Quit", the command line 

becomes : 

I T 

I 

Save Discard Return | 

J 

"Save" asks for a text file name. The author is prompted 
with the name of the current text file, if there is one. If 
the author hits <RET>, signifying that the current text file 
name is to be used for the changed text file, TEXTEDIT asks 
if the previous version should be replaced. There are no 
difficulties with replacing (writing over) the previous 

file. "Discard" destroys any changes made during the 

session, and the prompt asks if the author wishes tc recon- 
sider the decision to discard. "Return" continues the 
TEXTEDIT session where it left cff. 
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3. Changing Text 

Text frames can be modified at two different times, 
before and after a given frame has been kept. The actual 
changing process is the same f cr both. A section of text 
can have its attributes changed using the "New' 1 command. 
Either before or when "New" is invoked, the author cycles 
the working set of attributes to the one desired, using 
<CONTROL> and G pressed simultaneously. The new color must 
be the one used for the command line when the marking proce- 
dure of "New" commences. Only cne color can be changed at a 
time. If several new colors must be changed, each is a 
separate invocation of "New". When "New" asks for the upper 
left corner (which is under the upper left character or 
space) , the author positions the cursor in the proper posi- 
tion and hits the <DEL> key. The lower left corner is 
defined in the same manner. After the change is on the 
screen, the author is asked if the change is acceptable. A 
<DEL> keeps the change, and <ESC> aborts the change, and 
both return the author to the second level command line. 

"Insert" is used to insert characters. As described 
earlier, "Insert" does not wrap around, and ends with <DEL> 
or <ESC>. "Delete" removes the character to the right when 
the < SP ACE BAR > is used, and the rest of the line when <RET> 
is used. Backspacing restores a deleted character. The 
deletion process, as with "Insert", ends with <DEI> or 
<ESC>. "Xchange" exchanges character for character and ends 
with <DEI> or <ESC>. As with "Delete", backspacing returns 
the exchanged character to its original value. 

To reposition a block of text on the frame, the 
"Move" command is used. The author is asked to mark the 
upper left corner, then the lower right corner of the block 
to be moved. As with "New", the cursor position for each 
corner is under the respective corner or space. The next 
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question from "Hove" asks for the upper left corner of the 
destination postion (under the character) , again marked with 
<DEL>. The command's actions can be aborted at any time 
with <ESC>. If the moved text extends outside the frame's 
edges, the author is informed and is asked if the move 
should be done. A positive response destroys the over- 
hanging portion of the text. "Move" is terminated with 
either <DEL> or <ESC>. 

E. GEAFEDIT 

1 . Init ial St eps 

Before invoking the GEAFEDIT program, the author 
should be sure that there is sufficient room on the diskette 
to save the file. GEAFEDIT itself requires 137K bytes, plus 
2K for the NOMOUSE program. For example, a one segment, 37 
frame graphics file takes up 47K bytes of space. 

GRAFEDIt is invoked by typing GP._T EC< EET> . The 
first level command line is: 

j -j 

I Create Edit Quit 



As in TEXTEDIT, "Create" asks for a segment name, starts in 
Frame 1 and names the file at the conclusion of the session. 
Segment names should clearly indicate their posticn and/or 
function within a lesson. Also as in TEXTEDIT, ''Edit" asks 
for the file name, then displays the same sort of informa- 
tion on the file as described under TEXTEDIT. The author 
then either chooses to start a new segment or picks a previ- 
ously created segment. 



29 



2 • Creating a F ram e 
a. Set Up 

Once the new frame appears, the second level 
command line is: 



Create Edit Draw Modify Remove Keep Get View Help Stat 
X Text Quit. 

i j 



Most of the second level commands are explained 
later in the order that the author would probably use them - 
starting with "Status”, "Draw", "Create", "Get", "View", 
"Keep", "Edit", and "Modify". 

The remaining two commands are "Help" and 
"Remove". "Help" displays a frame containing one line 
descriptions of the second level commands. "Remove" 
displays the command line: 

i t 

Graphics All Unused Object Nothing ? Esc 

i 

"Graphics" removes only what has been drawn on the screen, 
while "All" deletes both what is on the screen and all 
objects, used and unused. "Unused" removes those objects 
not used in what has been drawn on the screen. "Object" 
displays a numbered list of all the objects on the frame and 
the author is prompted for the number of the object to be 
removed from the list. For each of the previously described 
commands, the author is asked to confirm that the item or 
items specified are to be deleted. "Nothing" and "Esc" 
escape "Remove" without deleting anything. "?" is the help 
command and was not available on version 111.0a of GRAFSDIT. 
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GRAFEDIT is also initialized with certain 
default values which are shown in Figure 3.3. The author 
invokes "Status" to view or change the default values. The 
default values are white solid line, white 




Figure 3.3 GRAFEDIT Status Frame 

solid zone and fill, white small dot marker, and black back- 
ground. Other default values with which the author may be 
concerned are the arrow skip value ("Ju") , which can be set 
from 1-255. A boundary ("Ba"), which is used in "Fill", 
can be either any line or be of the same color as the "Fill" 
color. Zoom ("Zo") can be done by a numerical scale value 
or by position. Rotation ("Gr") can be done by degrees or 
by position. On those items in "Status" where there are two 









possibilities, ("Zoom", for example) , invoking the item 
toggles the result. 

Colors are changed by invoking "Color" index, 
and then typing in the number cf the desired color (0-15). 
The selected color appears in the left-most box (labelled 
Current Color) in whatever the current pattern index is 
(default is solid). The new color is transferred to "Line", 
"Zone", "Fill", "Marker" and "Background" by positioning the 
cursor in the appropriate box and hitting <DEL>. The 

•"Pattern" index is also changed in this same way. The 

author selects "Pattern", then the index number (0-9), and 
moves the new pattern to the right area. The "Line" style 
is changed in much the same way by entering "Line" and then 
the style number (0-7). "Keep" saves the "Status" values. 
If the "Status" values are not kept, those changed values 
will only be maintained for a continuous session ("Quit" or 
"Discard" stops a session) . There is only one "Status" 
board per file. 

3 • Creating an Object 

As explained in Chapter II, the basic unit of a 
graphics frame is an object. Objects are created using the 
seven system primitives (line, circle, arc, etc.) or otner 
objects. The author starts the creation process by invoking 
"Draw" on the second level command line. 

The Draw command line is: 



i 1 

Lin Bez Mrk Zon Fl Cir Arc 0 t j X + - ? Grp Sty Rel Del 
Ver Esc Quit 

— 



See [Refs. 1,2] for complete descriptions of all commands. 
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a. Example Object Creation 



Figure 3.4 shows a simple arrangement of three 
boxes, a circle, and several dots. The order in which the 
objects are drawn on the screen is the same order which is 
used each time the frame xs later displayed. (It is 
possible to modify the drawing order later, if the author 
determines that the original order is incorrect.) To draw 
these shapes, the author selects "Cir" (circle) and is 
prompted for the center point, and then for a point on the 
circle. 




Figure 3.4 Sample Frame 

These points are entered by positioning the cursor with the 
function Keys and hitting <DEL>. The circle is drawn in the 
color specified in "Status" for lines. 
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The open box is formed by selecting "Lin" 
(Line). It can be drawn in two different ways. The picture 
on the screen is exactly the sane, but one method results in 
four groups, and the other in one group. The former method 
positions the cursor on one vertex, enters the point using 
<DEL>, moves the cursor to the next vertex, again entering 
the point with <DEL>, and then re-selecting "Lin". This 
process is repeated three times (except for the last step of 
the third iteration) . This results in four groups of one 
line (side) in each. The other method starts in one corner, 
enters the point with <DEL>, and then moves from corner to 
corner, entering the point each time with <DEL> . This 
results in one group with four lines in it. Whether the 
author chooses to use one method or another depends on the 
amount of later changes that may need to be made. The box 
made of four groups can be modified side by side, while the 
other box made of one group, can only be changed as a whole 
unit . 

The third object to be drawn is done by 
selecting "Zon" (Zone). The author moves the cursor to one 
corner of the zone, enters it using <DEL>, moves to the 
diagonally opposite corner, and enters it with <DEL> , 
completing the zone. A large zone (about 1/4th of a screen) 
can take an appreciable amount of time to draw and probably 
should be avoided. 

The third rectangle is a box created by drawing 
lines and then filling it with a pattern of diagonal lines. 
The box is drawn as previously described, then the author 
selects "FI" (Fill) . The cursor is moved to any point 
inside the box and entered using <DEL> . The box is then 
painted with the selected fill pattern and color. The fill 
proceeds until it encounters the boundary condition. This 
condition can either have the filling stop at a boundary of 
the same color as the fill, or at any boundary. The author 
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could inadvertently fill the whole screen if the wrong 
boundary condition had been set, or if there is a break in 
the boundary. "Fill" is slower than "Zone", and therefore 
should only be used in small areas (1/16th of screen or 
less ) . 

The final group on the frame is a series of 
markers. The author selects "Krk" (Marker) and then enters 
dots point by point with <DEL> (moving the cursor between 
points, of course) . 

b. Changing Styles 

If the author needs to change the color of a 
line, perhaps for drawing the box that was filled in the 
example, this can be done on a temporary basis by using 
"Sty" (Style) . The Style command line is: 



Color Index Default Mode Pause Ver ? Quit Esc 



When "Color" is selected, the color spectrum (as in Status) 
appears, in whatever pattern or style index is the Current 
Color as specified in "Status", temporarily replacing the 
command line. The author moves the cursor to the desired 
color and enters it using <DEL>. This does not affect the 
color kept in "Status" and the new color lasts only until a 
new option has been selected or until "Draw" has been 
exited, whichever comes first. 

c. Additional Considerations 

If the last action is a mistake, filling the 
whole screen, for example, "-" deletes the last object 
drawn. "+" will put back what erased. 

The principle for using "Arc" and "Bez" (Bezier 
curve) are similar to "Line", "Zone", etc. Bezier curves 
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require much practice in placing the control points properly 
to produce a recognizable and smooth curve. 

At this point, the author may wish to make modi- 
fications in what is on the frame or to make it an object. 
This can only be initiated on the second level command line. 
"Quit" exits "Draw" and returns the author to this second 
level. 



d. Naming the Object 

At the second level, selecting "Create" provides 
the author with the opportunity to name the object. The 

"Create" command line is: 

r -| 

Frame Object Current-frame | 

I ! 

"Object" asks if the current frame should be made into an 
object, and if yes, the author must provide a name for the 
object. Names should be unique, descriptive and comply with 
the naming conventions of the operating system (not more 

than eight characters long, etc.) . 

The author could have started the whole above 
process by naming the object, then drawing it, rather than 
as described. Selecting "Create", "Object" and then drawing 
the object, would have the same result as presented above. 

4 . Making a Fra me 

A frame is created either with named objects or by 
drawing the frame as a whole. "Create" frame is the default 
state for GRAFEDIT. The author is placed in that state upon 
entry to GRAFZDIT or after a frame has been saved. 

The objects used on a frame can either be ones 
existing on that specific frame, or can be located on 
another frame, or in another file. This concept of a 
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storage or library frame is very useful as objects need not 
be constantly re-created. The author obtains objects from 
other frames by the "Get" command on the second level 
command line. "Get" asks for a filename, and a segment name 
if there is more than one segment in the file, then displays 
the command line: 



r - 

Getfile Info Frame ? Quit 1 



"Getfile" re-starts the process of getting a graphics file. 
"Frame" prompts the author for a number within the specified 
segment. After the frame is displayed on the screen, the 
command line is: 



I *1 

Object All_objects Merge Next Prev Getfile Info Frame J 

? Quit 1 

I 

i i 

"Object" shows the author a list of the available objects 
and the author selects one by typing first "Number", then 

the object's number. " All_ob jects" takes all the objects 
residing on the frame, while "Merge" takes the objects and 
the frame. Whatever has been selected, whether an object or 
a whole frame, is merged with the current frame. If some of 
the new objects have the same names as ones on the current 
frame, the author is advised of this, but as the objects are 
given unique numbers on the object list, nothing is lost or 
destroyed. The new objects are added to the end of the 
object list. 

Once the needed objects have been obtained, the 

author makes the frame by invoking "Draw" and then "Object". 
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The "Object" first level command line is: 



1 

Use Copy ? Esc 

1 








1 


"Use" displays the list of 
beside those that have not 
line : 


named objects 
yet been used. 


with an 
and the 


asterisk 

command 


i 

Choose an object: Number 

1 _ _ _ _ 


? Esc 






J 

1 


If there are more objects 


than 


can be 


displayed 


in one 



column, "More" appears on the command line, and selecting 
it, cycles the object list to the next column of numbers. 
The author selects "Number", then types the number of the 
desired object. When the "Draw" command line re- appears, 
the object name is written one line above it at the left 
side of the monitor screen. The object is placed on the 
frame by positioning the cursor and hitting <DEL>. The 
actual object position will have the same orientation to the 
cursor as it had to the center of the frame when created. 
The author can either draw all the objects in the same 
manner, and then modify them to create the complete frame, 
or each object can be modified before drawing another. The 
latter method is especially useful when objects have been 
created and stored as a full screen version, but which will 
be used in a reduced size version. 

5 . Vie win a Other Frame s 

As mentioned in the section on TEXTEDIT, the author 
needs to make reference to the associated text frames to 
ensure proper object placement. This is accomplished at the 
second level command lice with the command "Text". If no 
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text file has been specified in "Status”, the prompt asks 
for the file name and the segment name (if more than one 
segment is in the named file) . The "Text" command line is: 

! 1 

Getfile Segment Clear Frame Next Previous Quit 

i 

The explanation of these commands is the same as for viewing 
graphics files from TEXTEDIT. 

The author may wish to see other graphics frames or 
objects. This is done by using the "View" command on the 
second level command line. The "View" command line is: 

i 1 

Local_object Names Frame Object Curren t_f rame Esc 

{ ! 

"Local_ob ject" allows the author to view objects from the 
current frame, while "Object" allows the author to view 

objects on a different frame. "Frame" displays a frame from 
the current file or another file. "Names" displays object 
names and allows the author to change an object"s name. 

"Current_frame" re-displays the current frame. 

As with TEXTEDIT, the author must first "Keep" a 
frame, in order to proceed to the next frame. If some 
objects were unused on the frame, the author is asked if 
they should be kept. The author exits GRAFEDIT by typing 
"Quit" on the second level command line. As in TEXTEDIT, 
the command line now is: 



i 1 

Save Discard Return 

i 

"Save" will keep the changes, and as with TEXTEDIT, it is 
acceptable to use the same name for the changed file as for 
the original one. 
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6. Ch a ng ing Frames And Objects 
a. Editing 

Editing is initiated from the second level 
command line. The "Edit” command line is: 

r 1 

Frame Object Name Esc 



"Edit Frame" will change an existing frame, either in the 
current file or in another file. Editing a frame means 

modifying the objects or groups that compose it. This first 
level of editing uses the highest level of objects on the 
frame. So if objects were used to create other objects 
before being drawn on the screen, only the outermost layer 
of objects will be available when "Edit Frame" is selected. 
The only changes are to the various objects as complete 
entities. That is, change in size or orientation of a whole 
object is possible, but not changing the color or size of 
any object that makes up the high level object. The author 
can edit an existing frame, then edit an object on that 
frame. "Edit Object" operates on objects in the current 
frame only. Once edited, all uses of that object on the 
current frame reflect the changes. "Edit" only changes the 
state away from "Create", the actual changes are accom- 
plished through "Modify" or "Draw". 

b. Modifying Commands 

The Modify command line is: 



1 








Move 


Rot 


Ext 


Zoom Sty Fir Last Bfore Del Win + - ? X 


Undo 


Add 


Ver 


Quit 








j 
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When Modify is invoked, the current object or group is 
displayed to the left of the monitor screen on the line 
above the command line, and its control points are high- 
lighted. The author can cycle through the objects or groups 
that compose the frame or object by using "+" or "-". 

An object or group can be moved from one posi- 
tion tc another by using "Move". The first point required 
is the origin reference point. The second one gives the 
direction and distance of the move. The object is moved 
with respect to its position about the origin point. 

Objects or groups can have their orientation 
shifted by using the "Hot" (Eotate) command. "Rotate" 
requires either three points cr two points and a degree 
amount. The first two points for either method set the 
origin and the reference line. The third point or the 
amount sets the degree of rotation. 

Once the desired object or group has been 
selected, the author can change the size by using "Ext" 
(Extend) or "Zoom". "Extend" stretches the object cr group 
in the specified direction by the specified scale factor. 
"Extend" ’s scale factor requires three points: the first is 

the anchor, the second sets the unit distance and the direc- 
tion of the scaling, and the third gives the scale factor 
with respect to the anchor point. "Zoom" scales the whole 
object or group by the specified scale factor (a shift in 
two dimensions) . After either of these two commands is 

selected, the author is prompted for the necessary values. 
The scale factor can be entered by position or by number. 
Both "Extend" and "Zoom" require an anchor point and a 
second point to determine the unit distance. The method for 
determining the scale factor is that specified in "Status" 
("Zo" on "Status" command line) . "Position" requires a 
third point to set the scale, while "Value" provides the 
actual scale factor. The method is previously selected in 
"Status" ("Gr" on the command line) . 



A group’s attributes can be changed by using 
”Sty" (Style) . The method is the same as was described for 
changing the style in "Draw". 

"Del" (Delete) removes the current object or 
group. "Add” replaces what "Delete" erased. "Undo" erases 
the last change. The author returns to the command line by 
typing "Quit". 

F. BUILDER 

1 . Struct ure 

Lesson construction in BUILDER revolves around the 
concept of a path and its branch points. A path can be 
strictly linear with no branch points (similar to reading a 
book from cover to cover) , or it can have branch points and 
offer many choices (like a "tree" structure). The 
complexity of a path increases in direct proportion to the 
number and type of branch points. A branch point is a place 
in the path where the student is required to make a choice. 
The choice can be in response to a question on the lesson 
material, or it can be a choice on what material the student 
wishes to see (choosing to use a Help segment, for example). 
Each path must end in one way or another, or an error or 
ambiguous situation results. Paths may end by jumping to a 
label ("GoTo") , "Join"ing the next step, "Halt"ing (ends the 
lesson sessio n ) , "Exit"ing (ends the lesson s egme nt ) , or 
"Repeat"ing the decision point (Figure 3.5). 

This section will explain how to build two different 
structures: a menu or control segment (Figure 3.6) and a 
short called segment (Figure 3.7). 

2 . Initia l St eps 

BUILDER is invoked by typing 3UILDSR<RET> . The 
author must ensure that sufficient space is available to 
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Figure 3.5 Examples cf Path Terminators 

store the four files that 3UILDER creates (.RUG, -TXT, .PAG, 
and . GR F) . BUILDER itself reguires 143K oytes of space. 
For example, a short four frame lessor, with no graphics 
required 8K bytes of space, and a menu with eight called 
segments needed 16K bytes. 

A text and a graphics file are needed to create a 
BUILDER lesson segment. Even if the graphics file is not 
needed, BUILDER allocates 8K bytes despite having no 
graphics in it. It is, therefore, more space efficient to 
have a graphics file, even if it is not used in the lessen. 
The text and graphics files required for EUILDER will prob- 
ably not fit on the same diskette as the 3UILDER program and 
the four lesson files. 

A BUILDER convention reguires that the lesson name 
and the segment name be the sane. The lesson name is what 
will be the file name with the four extensions mentioned 
above. The segment name is what is referenced by calls 
within the lesson. 

Once BUILDER has been invoked, the first prompt is 
for the lesson name. If a lesson of that name already 
exists, the author is asked, in turn, if each of the four 
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[Ref. 2: p. 15], 



Figure 3.6 Menu Segment 

lesson files should be replaced. A negative response will 
result in a request for a new lesson name. The second 

prompt is for the segment name, which should be the same as 
the lesson name. The third and fourth requests are for the 
text and graphics files, respectively. If either has more 
than one segment, the segment name is requested. 

The first level BUILDER command line is: 



i 1 

Branch Clear Display Remember Use <.> 

File Status Wait View Prompt Quit <-> 
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1 


Display-Text frame 


1 


1 

* 

1 


Prompt student by flashing 




1 

* 

1 


Display-Graphics frame 




1 

* 

1 


Wait for 10 seconds 




1 

# 

1 


Ciear-Portion 




1 

* 


Wait for student to type any key 




[ Ref • 2: p, 2 ], 




J 



Figure 3.7 Called Segment 

The period# <•>/ toggles the command line. Most commands 
can be aborted, once invoked, by <ESC>. 

3. Buildi no a Lesson 

a. Set Dp 

Before the lesson building actually begins, tne 
author may need to alter the default values in BUILDER. 
"Status" displays the default values (Figure 3.8). The 
"Status" command line is: 

i 1 

Text Graf Char Accur Upper Wait Field Delay Note Back 
Exit 



As mentioned in TEXTEDIT, 3UILDER contains the background 
color specifications. The author can change the color by 
selecting "Back" (Background) , and typing the number (0-7) 
of the desired color. The default color is black. 
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Text 

segment 
Graf 
segment 
Character set 
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Uppercase 

Wait 

Delay 

Fields 

Answer 
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Duration 
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[ filename ] 

[segment name] (0) [0 of frames] 
[ filename ] 

[segment name] (0) [# of frames] 
♦System 



3.00 

True 

<Any key> 

0.00 

4 

4 

350.00 

0.33 

0 



Right Counter: Off 

Wrong Counter: Off 

Memory left: 7980 

0 questions incomplete 



Unused labels: 

A3CDEFGHIJKLM 
NOPQRST'JVWXYl 
Undefined labels: 



Set labels: 



0 1 

Main STATUS: 



2 3 4 5 6 7 3 9 10 11 12 13 14 

Text Graf Char Accur Upper Wait Field Delay Note Back Exit 



1 [Ref. 2: p. 53], 

i 



1 



I 

J 



Figure 3.8 BUILDER Status Board 

"Accur" (Accuracy) is measured in percent wrong and ranges 
from 0.02 to 100. It refers to the student's response or 
choice at a branch point or after a question. "Note" has 
the frequency in Hz and time of the prompt duration in 
seconds. The "Freq"uency range is 0-20 KHz, and the note 
"Dur"ation is 0.034-60.0 seconds. "Exit" returns the author 
to the first level command line. 

During the lesson, the author can, and should, 
enter "Status" to check which labels have been properly set, 
and which have been used without being defined. Undefined 
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labels result in undetermined paths. 



an 



error . 



or in other words. 



b. Displaying and Clearing Text and Graphics Frames 

Generally it is a good idea to both begin and 
end a segment with a clear screen. This avoids inadvertent 
overlaying of frames. "Clear" has the command line: 



I I 

| Text Graphics Both Answer Reply Counter j 

i i 

The "Clear Text" and "Clear Graphics" commands are used when 
only the text or graphics portion of a screen need to be 
erased. Text clearing is done line-by-line from top to 

bottom, and so is rather slow. "Clear Beth" is faster than 
"Clear Text" and can be used even if there are no graphics 
present on the screen. 

Text and graphics are put on the screen using 
the "Display" command. The "Display" command line is: 



i 1 

Text Graphics Echo Counter Reply Video 

i i 

Both the "Text" and "Graphics" commands, when invoked, 
display the range of frames present in the specified segment 
and reguest a frame number. When the requested frame is 
displayed, the author must confirm that the frame shown is 
the one desired. If it is net the right frame, another 

frame can be requested at that time without leaving "Display 
Text" or "Display Graphics". 

Text and graphics frames may be overlaid to 
create the lesson frame. The order in which they are 

displayed is totally dependent on the text and graphics 
frame composition. Overall, it is probably better to show 



text first, as it is displayed more rapidly than graphics, 
and the student has something tc look, at almost immediately. 
Use of text labelling on graphics frames, however, usually 
requires that the graphics be displayed first (labelling of 
inputs, outputs, ground and power in a circuit diagram, for 
example) . Often labels are overlaid directly on figures, 
and due to the opacity of VCIS frames, the sequence must be 
graphics, then text in order for the text to be visible. 

Once displayed, the text and graphics should 
remain available for the student to read for a certain 
period of time. This period cf time may be set by use of 
"Wait”. The "Wait" command line is: 

r j 

Default Any_key Frame Key System Time J 

i i 

"Any_key", "Key", and possibly "Default" (depends on what 
"Default" has been set on in "Status") , require the author 
to specify a cursor display position. The bottom right 
corner of the monitor screen displays the line and column 
number of the cursor position. "Key" has the author select 
any one key that the student must depress before the lesson 
continues. "Time" sets a period of time from 0.1 to 300.0 
seconds. This is most useful in displaying the logo or 
title frames. "System" is similar to "Any_key" and "Key". 
It uses <SPACE BAR> and does not require specification of a 
cursor display position. 

c. Using a Lesson Segment 

One way to minimize building complexity, and to 
ease editing or modifying of lessons, is to split long 
lessons into segments. This is also useful in creating Help 
segments and in menu structures. 
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The "Use" command line is: 




"Graphics" and "Text" store frames for use in a "special" 
lesson segment. "Special" calls a Pascal program written by 
the author to supplement VCIS. "Lesson_segment " prompts the 
author for the segment name. This can be used to call a 
Help segment or as part of a menu structure, where when the 
student selects a certain option, the result is a call (use) 
of a lesson segment (see Figure 3.6). 

d. Branch Points 

The actual structure of a lesson is determined 
by use of various branching techniques. Only selected 
branching instructions will be explained in depth here. See 
[Ref. 2] for further details. The "Branch" command line is: 

i 1 

Keyboard Counter Memory - Label - GoTo Exit Halt Join 
Repeat 



"Keyboard", "Counter", and "Memory" define where the deci- 
sion information on a branch is to be obtained. The other 
six commands are either path terminators, or are used in 
path termination, and are explained later. 

The "Keyboard" command line is: 



i 1 

Answer Character Position - Timeout 
; j 



"Answer" first has the author select the area of the monitor 
screen where the student enters his/her response. The left 



edge of the space is selected first, (using the function 
keys to move the cursor and <DEL> to select it) , and then 
the right edge. This space may be at most one line long. 
The column and line position of the cursor is displayed in 
the bottom right corner of the screen. The type of "Answer" 
that may be put in that space is selected from the command 
line : 

I I 

Neutral Right Wrong Unmarked - Switch 

i 

Selection of "Neutral", "Right", and "Wrong" requires 
construction of a path. The next command line is: 

i 1 

I String Pattern Numeric Missirg Unanticipated 



The author must build the expected answers, whether right, 
wrong, or neutral, first, before doing the unanticipated 
answer. The unanticipated response is used as the default 
and must be constructed last. 

A "String" answer is composed of up to 75 char- 
acters, which may include the logical operators AND (S) , OR 
( ) and NOT X- Sample strings can be tested using SC0MPAR2 
(before or after BUILDER session) to verify a match. 

Choosing "Keyboard Position" is useful in 
creating a menu structure. The author must first mark the 
cursor display position using <DEL>. As with "Answer", the 
next command line is: 



| Neutral Right Wrong Unmarked - Switch | 



"Neutral", "Right", and "Wrong" all lead to: 
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, 

Anticipated Missing Unanticipated 

I 



"Antici pated" has the author mark (with <DEL>) first one 
corner and then the diagonally opposite corner. 

Once the corners are marked or the string is 
specified, the author continues the path that that partic- 
ular student response has chosen. At this point, the path 
may use a segment, display text or graphics frames, etc. 
The path ends with another invocation of "Branch". 

e. Path Terminators 

Path terminators are selected from the "Branch" 
command line: 

i 1 

Keyboard Counter Memory - Label - Goto Exit Halt Join 
Repeat 



"Halt" is only used to terminate the lesson session, while 
"Exit" is used to end a lesson segment. "Goto" reguires a 
label to which to branch, and "Label" sets this point. If 
an author wants the student to see a certain frame, the 
label should be placed before the frame is displayed. The 
student will not see the frame, if the label is defined 
after the frame has been displayed, even thoug'h the clear 
command has not been issued. "Join" simply continues on to 
the next command after the branch point. "Repeat" returns 
the student to the last decision point. It can be used for 
an unanticipated answer or for the path default. The author 
is asked to confirm the path terminator in all cases before 
the next command is accepted. 
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f. Ending a Segment 



As mentioned in path terminators, the ways to 
end a segment are with a "Goto", "Join", "Exit", "Halt", or 
"Repeat", As the path progresses, there is a number or 
"Main" to the left of the command line. This indicates 
which path the author is creating. For example "2.3.7" 
would indicate that the author is on the second path from 
the main branch, the third path down the second route, and 
on the seventh branch from the third. Any time a default 
path is being built, the number terminates in a "D" ("1.D", 

for example) . 

4. Editi ng a Segment 

There is no editing capability in the BUILDER 

program similar to that of TEXTEDIT or GRAFEDIT. Changing 
or modifying a segment is either done by brute force 

(totally redoing the entire segment) or through use of 
files. The BUILDER command file (.TXT) can be edited using 

a text editor and then used instead of keyboard input. The 

command "File" gives the command line: 

i 1 

Breakpoint Comment Input 



"Input" calls this command file. If changes are necessary 
in the graphics or text files, but not in the command file, 
the author has to rebuild the segment but can use "File" to 
produce the command file. 
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G. INTERP - TEST MODE 



1 . Init ia l Ste ps 



When used in the test mode, INTERP is invoked by 
INTERP<KET>. There are no files created nor is any informa- 
tion recorded in test mode. INTERP is 157K bytes and so it 
may not be possible to put the segment to be tested on the 
same diskette. When the lesson name to be tested is 
requested by INTERP, if other than the default (same drive 
as INTERP) , the actual location of the test segment must be 
specified. INTERP must have the four files generated by 
BUILDER (.RUN, .PAG, .GRF, and .TXT) for each segment or the 
three files created by LINKER in joining segments together 
(.RUN, . GRF and .PAG) . 

Upon invocation, INTEEP asks for the 
and if tracing information is to be displayed, 
information shows the question and path number, and text and 
graphics frame number (not as created in TEXTEDIT or 
GRAFEDIT, but numbered sequentially from the 
the segment) . 



lessen name. 
The tracing 



beginning of 



2 . Sequent Testing 



There are only two major differences between the 
testing and the final mode of lesson operation. One is that 
in the testing mode, the lesson management conditions 
supplied by MANAGEE.DAT are not available. The other is 
when a segment is called and is not linked to the segment 
actually under test. INTERP returns a message stating 
"Calling segment" and continues the segment being tested. 
It is therefore possible to test ail segments created by 
BUILDER, whether the segment is a menu or control segment 
which calls other segments, cr the segment is a called 
segment. A correctly built segment operated under INTERP 
should operate exactly as if it were being actually used by 
a student. 
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The segment being tested can be terminated either as 
specified by the author or in a less graceful manner by 
<ESC>. The escape gives the command line: 

i 1 

Resume Stop Backup Comment 

{ 

This escape mechanism is always available, even during the 
final mode, but it is intended as an emergency exit and as a 
means of allowing student comment or backup. The <E3C> 
works when INTERP is waiting fcr a response. It will not 
work, for example, if INTERP is in the middle of a timed 
wait period or in the midst of a text or graphics display 
process . 

H. LINKER 

1 • Initia l Step s 

LINKER is invoked by LINKER<RET>. The author can 
specify only one control segment and eight called segments. 
It is possible to have a called segment itself be a control 
segment which calls other segments. Another possibility is 
using one version of the lesson as the control segment, with 
the called segments being corrected versions of segments in 
the "control" portion. 

2. Lin k in g Segments 

TJhen invoked, the first prompt in LINKER is for the 
host segment (or the control segment) . The following eight 
prompts are for called segments. Any or all of the segments 
may be on a diskette in a drive other than the one occupied 
by the LINKER diskette. If less than eight called segments 
are used, the author types <EET> to continue. The next 

prompt is for the name of the output segment, which may also 
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te placed on a diskette different from. that of LINKER. If 
there is already an output segment of the same name, the 
author is asked if it should te replaced. Segnent names 
only must be used - if a lesson name is used, the linking 
procedure will not work. LINKER displays the names of the 
segments as it is linking them. If one segment calls 
others, they also are listed. 

3. Poss ib le E rrors 

If a segment cannot be found (for example, because 
of a misspelled name), LINKER returns and states that the 
segment cannot be found. If the file (lesson) name and the 
segment name are not the same, there may not be an error 
message, but when LINKER displays the names of the linked 
segments, the incorrectly named segment will not appear, as 
it has not been linked. If something occurs to cause LINKER 
to terminate, and if there is no apparent reason for the 
termination, LINKER should be executed again. The author 
may need to enter the called segments in a different crder. 
The order entered in LINKER does not affect the final 
version. 

I. MANAGER 

MANAGER is invoked by typing MA NAGER<R ET>. It does not 
reguire the presence of any files. When MANAGER is invoked, 
the first prompt is "Using which directory?" It is best to 
use the same directory or disk drive upon which MANAGER is 
residing. If MANAGSR.DAT is not present, it is created. If 
no reply file or if no student roster is kept, the initial 
MANAGER . DAT file is 6K bytes. 
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If there is a MANAGER.DAT file present in the directory, 
the command line is: 

i 1 

Status Names Replies List Quit | 

i i 

If MANAGER.DAT was just created, .the system is placed imme- 

diately into '’Status’ 1 . The default values for the lesson 
management conditions in MANAGER are shown in Figure 3.9. 



STATUS: <A..L> <RET> <ESC> 

A. videodisk/tape F 

B. halt F 

C. record path F 

D. unanticipated F 

E. backup T 

F. use roster F 

G. use passwords F 

H. use student ID # — F 

I. use replies F 

J. segment and frame 

K. string locations: 

L. lesson name: 



Figure 3.9 Manager Status Board 

They are changed by typing the letter of the line and then 
typing either "T” or "F". A "True" response means that 
lesson management condition is allowed. The lesson name 
must be entered and it can indicate that the lesson resides 
on a disk or drive that is different from MANAGER.DAT. If 
passwords, replies, roster or IE numbers are to be used, the 
author must supply them. The changes in "Status" are kept 
and the author is returned to the command line with <REI>. 
The roster, ID numbers, and passwords are entered after 
invoking "Names". Replies are entered after invoking 
"Replies". "List" changes the student roster. When "Quit" 
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is invoked, the author is first asked if the file 
(MANAGER.DAT) should be updated, and then if another direc- 
tory is to be done. The response each time is "Y"<RET> or 
"N"<RET>. 



J. INTERP - FINAL NODE 

This is the final version of the tutorial as seen by the 
student. INTERP, MANAGER.DAT, and the lesson file specified 
in MANAGER.DAT must be present, although not necessarily on 
the same diskette. If any of the lesson management condi- 
tions have been specified and if the lesson itself is large, 
there probably will not be enough room on one diskette. 

The lesson can be invoked first by INTERP<RET>. INTERP 
should be changed to something a little more descriptive of 
the tutorial before it is presented to the student, however. 
Under the Microsoft Dos, this is done by "REN oldfile- 
name . extension new filename, ext e ns ion" . 

K. LISTFRAM 

LISTFRAM is the program used to display text or graphics 
frames at the terminal. Text frames can be converted from a 
non-ASCII file to an ASCII file which is suitable for 
printing. 

The program is invoked by USTFRAM<RET>. The command 
line is: 

« 1 

Text Graphics Quit 



When either "Text" or "Graphics” is selected, the procedure 
is the same. The next prompt is for the filename. The file 
may reside on a drive or diskette that is different from 
LISTFRAM. As LISTFRAM is 70K bytes, it is possible to have 
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the file to be listed on the same diskette as the listing 
program. 

The next command line is: 



i i 

All Frame Getfile Help List Output Part Quit Segment 




If there is more than one segment in the file, "Segment*' 
must be invoked. "Part" lists part of the file. The first 

prompt is for the starting frame number and the second 
prompt is for the ending frame number. "All" starts with 
the first frame and lists all cf the frames in the segment. 
In either of these commands, the command line for each 
displayed frame is: 

i 1 

Next Previous Quit 

i 

The clearing of the screen between frames is taken care of 
by LISTFEAM. 

"Getfile" is used to obtain another text or graphics 
file for listing. It basically re-initializes LISTFRAM in 
text or graphics listing mode, whichever was first selected 
upon invocation of LISTFRAME. To switch from listing 
graphics to text or vice versa, the author must return to 
the first level LISTFRAM command line. "List" displays 
information on the file previously specified in the same 
format used in either TEXTEDIT or GRAFEDIT. "Help", as in 
previously described VCIS programs, displays a frame 
containing one line descriptions of LISTFRAM commands. 
"Frame" asks for one frame nuiiber and then displays that 
frame. 

At this time, only text frames can be printed out. The 
University of Utah programmers are working on a program for 
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Text files are 



the IBM PC that will print graphics files, 
printed by invoking "Output". The new command line is: 

i 1 

Console Disk 

i i 

The author picks "Disk" and is then prompted for an output 
filename. This name may be the same as the TEXTEDIT file as 
the extensions are different. Selecting "Disk" changes the 
default listing location for future LISTER AM commands. Dow, 
by invoking "All", the text file is converted and listed 
into the disk. The actual printing is done after LISTFEAH 
has been exited with "Quit". The print command for the IBM 
PC is "prn filename. extension" . 

L. SUMMARY 

This chapter has been included to provide the prospec- 
tive author with a basic knowledge of VCIS commands. It is 
not intended to replace the User’s Guides, and should be 
read in conjunction with the Guides. The following chapter 
shows how this authoring system was used to create two 
tutorials. 



IV. CREATION OF VLSI TUTORIALS 



A. INTRODUCTION 

All of the VLSI computer-aided design (CAD) tools at the 
Naval Postgraduate School reside at present on the VAX 
11-780 operating under the Berkeley UNIX 4.2 operating 
system. As there were no short easy tutorials available for 
first time users to become acquainted with UNIX and one of 
its text editors, vi, it was decided that UNIX would be the 
first tutorial. This tutorial does not require the use of 
graphics and so eases the learning process involved witn a 
complicated authoring system like VCIS. The second tutorial 
then introduces the student to the world of VLSI - through 
its shapes, colors and notations. Graphics is a major 
portion of this tutorial. The two tutorials together exer- 
cise most of the functions or options of VCIS. No video 
segments were used, as it was decided that the material was 
not suitable for video. A copy of the UNIX tutorial is 
provided in Appendix A and a copy of selected portions of 
the VLSI tutorial is in Appendix B. 

B. LESSON PLANNING 

1 . Struct ur e 

One of the first decisions made was to use a menu- 
driven structure. Students dc not always have the solid 
block of time needed to complete one long sequence of text 
and questions, nor is it easy for them to start in the 
middle of a long sequence after a lapse of time. The menu 
allows them to choose to do those sections for which they 
have time, or which they wish to review before continuing. 



60 



A menu-driven structure also lends itself very well to divi- 
sion into segments which can be more easily built and 
modified. 

The VLSI tutorial has not only the main menu, but 
two embedded menus. The author decided that the amount and 
type of material would fit together better in this manner. 
The section on inverters, NAND, and NOR gates is a lengthy 
section if done as a whole, but is more manageable for both 
the author and the student when separated into three 
subsections. 

2 . Questi ons 

The next decisions made were on the type of gues- 
tions. The first tutorial on UNIX needed questions that 
required the student to actually perform the commands rather 
than memorize a response. This was achieved by using a two 
screen approach where the student logged onto the UNIX oper- 
ating system at the same time he/she "booted up" the lesson 
on the IBM PC. The student was provided with a selection of 
files for practicing file manipulations, as well as text 
editing. 

The second tutorial did not use questions at all as 
it was decided since the questions that could be asked would 
be trivial, it would be better not to ask any. It was 
assumed also that a student doing this tutorial would also 
be taking a class in VLSI design and so would be doing 
problems/questions for the class. The format for the 
shapes, colors and notations tutorial became that of screens 
of text. The student is presented with a design problem 
upon completion of the tutorial that is intended to be a 
paper-ana-pencil design checked by the instructor. 



61 



3. Assistance 



The first tutorial reguired that KELP be available 
for each command under instruction. There is no on-line 
help available in vi (the text editor) and while there is 
assistance in the main level of the UNIX operating system, 
it would be disruptive to the lesson to have the student 
accessing it. As the student was not answering guestions in 
the second tutorial, help does not need to be available. 

C. TEXT 

1 . Text Composition 

For both tutorials, the text was edited to ensure 
that each frame was complete in itself with little need to 
refer to a previous frame. The author also ensured that the 
amount of text on the screen was not excessive. This is of 
particular importance in the VLSI shapes, colors and nota- 
tions tutorial where graphics cccupy a significant portion 
of the screen. 

The UNIX tutorials are designed to present the 
minimum amount of knowledge a student needs to get on the 
system and do limited file manipulation. The student can 
either do selected sections for a bare minimum of knowledge 
or do the entire tutorial to gain knowledge of a few more 
complicated commands that do the same processes in another 
manner. It does not attempt to cover all commands or all 
options within a specific command, but is only meant to 
provide a means for the student to start on the UNIX. 

The VLSI tutorial follows [Ref. 3]. This was used 
because the author assumed that the text used for a VLSI 
class would most likely be this one, and so would not 
present any conflict with material presented in class. 
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2. File Order 

The principles and actions for entering or changing 
text were the same for both tutorials. A copy of the first 
tutorial is listed in Appendix A. Wherever possible, the 
author attempted to maintain the tutorial text in seguential 
order according to segments. That is, a control section 
(the menu) is done first, followed by sections called by the 
menu. Each section is preceded by a chapter title page. 

3 • A ttribute Selection 

The process of attribute selection was basically the 
same for both the UNIX and the VLSI tutorials. The only 
difference is that the attributes selected were different, 
as the author wanted to see the effect of different colors 
in the presentation of the material. 

When TEXTEDIT was first entered, the author edited 
the working set of colors to achieve a harmonious grouping 
of colors. Yellow, white and red were used as highlighting 
colors, with blue, green and gray used as primary text 
colors. Gray was used in the VLSI tutorial to contrast with 
the colors used to identify the various layers (for example, 
red is used for polysilicon) . There was one set of colors 
used on the menu for cursor positioning instructions, and 
other colors for section names and selection instructions. 
Each frame had a section title at the top that was composed 
of one of the text attributes having a different background 
color frcm the rest of the frame (black was always used as 
the lesson background color). The frame title for help and 
summary frames was done with a different attribute than the 
rest of the section to emphasis the nature of the frame. At 
least one color having an underlining was selected. 
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4 . Tex t In p ut 

The process for text input for the two tutorials was 
exactly the same. The only significant difference was due 
to the use of graphics in the VLSI tutorial. This necessi- 
tated constant checking between the text and graphics to 
ensure that nothing had been covered up and that the frame 
was net crowded. 

A text frame was also created by overlapping previ- 
ously created frames. This was of particular use in the 
menu segments, where the only difference between one frame 
and another, was the section of the menu which had been 
highlighted. 

5 . Text Modifications 

As before the only difference between modifying text 
in the UNIX tutorial, and in the VLSI tutorial, was the 
graphics used in the latter one. Large scale modification 
of text was not possible without constant reference to the 
graphics frame. 



D. GRAPHICS 

1 • Ob ject Selection 



The VLSI tutorial is the only one of the two that 
uses graphics as a vital ingredient. It was not appropriate 
to use any graphics to describe UNIX. The objects selected 
for the VLSI tutorial were taken from [Ref- 3]. They were 
also chosen for their simplicity - both for ease in creation 
and ease in comprehension. 

2 . Object and F rame Creat ion 



The basic unit of a graphics frame is 
For example, the layout notation for an inverter 



the object, 
was done by 
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E. BOIL DING THE LESSON 



1 . Using BUILDER 

The sequences used to tuild the two tutorials were 
essentially the same- In each the menu segments were built 
and tested first, followed by the called segments. As 
mentioned previously, only the VLSI tutorial has graphics. 
The VLSI tutorial also has embedded menus but those were 
created in the same manner as a main menu and linked in the 
same way. 

The lessons were usually created by "Display ,, ing 
first "Text" and then "Graphics" (except no graphics in UNIX 
tutorial). In those instances in the VLSI, tutorial where 
the graphics would have covered up the labels, the above 
order was reversed. The lesson either "Wait"ed for a 
certain period of "Time" or for a signal from the student 
(usually <RET>) before progressing on to the next stage of 
the lesson. Based on student surveys, the author determined 
that a signal from the student was preferred, since reading 
rates varied as did the possibility of interruption. The 
"Clear Both" command produced a rapid clearing of the screen 
and so it was used even when no graphics were present. 
("Clear Text" does so line by line while "Clear Both" clears 
the whole screen simultaneously.) 

When a frame asked a question or required a choice, 
a "Branch" point was needed. For example, when the student 
selects a section on the menu, it is done by "Position" ing 
the cursor. An invalid or "Unanticipated" response presents 
the same screen again and again until a correct response (in 
this case, a correct position) is obtained. 

Once a correct section was made, the author "Use"d 
another "Lesson_segment" (called a separately created 
segment) . At the completion cf the called segment, the 
student was returned to the main or section menu, with the 
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most recently completed section highlighted. The author 
briefly considered structuring the menu to postion the 
cursor on the next section on the menu after a given section 
was completed. This was not done, as the number of possible 
paths rapidly becomes unwieldy. 

In the UNIX tutorial, the student could choose to go 
ahead to the next frame, go tc a help frame and rarely to 
back-up to a previous frame. This choice was also provided 
through "Branch ,, ing by a certain "Answer" provided on the 
"Keyboard". A "Right" answer got the indicated response, 
while a "Wrong" or "Unanticipated" answer repeated the 
frame. Each possible path at a "Branch" point was 
terminated properly. 

In the UNIX tutorial, when the student "Halt"ed the 
tutorial, the possibility for comment was provided and the 
PC would "Remember" the student comment. This appeared to 
cause some confusion with the students and so was not used 
in the VLSI tutorial. 

Each tutorial was tested by segment, menu-linked 
segments, and in total. The menu control segments were 
tested before they were linked to the called segments. They 
showed correct operation if the statement "Calling segment" 
was displayed when the USE statement was encountered. Each 
called segment was tested to shew that it branched correctly 
at the desired points and responded properly to wrong 
answers. 

The menu segments were connected together eight at a 
time using LINKER. The author had to ensure that sufficient 
disk space was available to hold the completed lesson. The 
completed VLSI tutorial is too large ( 1 3 0 K) to fit on the 
same disk as all its component parts. When the segments 
were all linked, the completed lesson was again tested using 
INTEEP. 



67 



2. Final Lesson Made with MUGGER and IN TERP 

After each tutorial had been tested, its MANAGER- DAT 
file was created using MANAGER- In the UNIX tutorial, the 
only special lesson management condition reguested was 
recording student path and response. The VLSI tutorial used 
none of the special lesson management conditions provided as 
problems occurred that appeared to be linked to these 
functions. 

When complete, the command name, INTERP, was changed 
to something more descriptive of the individual lesson - 
VIUNIX for the UNIX tutorial and SHAPES for the VLSI shapes, 
colors and notation tutorial. The student then uses the 
name VIUNIX or SHAPES to do the tutorial. 

F. STUDENT COMHENTS 

The author used a student opinion form on the first 
tutorial (see Appendix C) to help in the structuring of the 
second tutorial. Student comments on the UNIX tutorial were 
generally favorable. The author had asked questions on the 
effect of colors in text and if waiting for a signal was 
preferred over automatic change of frames. The students had 
no comments or criticisms on color selection. They did, 
however, prefer the use of a signal to an automatic change 
of frames. 
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V. EVALUATION OF VCIS 



A. IBTRODUCTION 

VCIS provides a flexible and comprehensive means of 
producing tutorials. The current versions of the programs 
are very user friendly. It is possible to learn the system 
by using only the documentation and the help provided with 
each program. 

B. GRAFEDIT 

GRAFEDIT is a program that makes the creation and modi- 
fication of graphics frames easy and relatively painless. A 
feature that is especially nice, is the ability to change a 
color or pattern within the DRAWing context without 
suffering the disruption of going into the STATUS board to 
make the changes. Another welcome feature is the ability to 
cycle within the objects on a frame or within groups within 
an object during the modification process. 

C. VCIS AVAILABILITY 

VCIS documentation lists several micro- and mini- 
computers that can use VCIS. The author can speak from 
experience on only two of these - the IBM PC (with Tecsar 
Graphics Master Color Board) and the VAX 11-780 with 
Berkeley UNIX 4.2 operating system. The IBM PC version is 
vastly superior to the VAX version that was available in the 
spring of 1984. 

Part of the problem is due to the time sharing environ- 
ment of the 11-780, of course, and cannot and should not be 
attributed to VCIS. The rest is due to emphasis by the 



University of Utah on the microcomputer versions of 7CIS. 
This is an entirely valid perspective for this authoring 
system as the microcomputer environment is much more respon- 
sive to the needs of the author. 

D. COL CE SPECTRUH COBFLICTS 

At present, the most annoying problem left in VCIS, and 
it is admittedly a minor one, from the author's point of 
view, is the discrepancy between the colors when viewing a 
frame produced by one program in the context of another. 
The color spectrum has eight darker, more vivid colors on 
one side and eight lighter co.lors on the other side (16 
colors on an IBM PC with Tecmar Graphics Master Color 
Board) . The order (light vs. dark) varies from program to 
program. There are two examples of this. The first example 
is the creation of a graphics frame using a dark vivid red 
and green. When this frame is viewed by either TEXTEDIT or 
BUILDER it appears as a pale red and green, and when seen in 
the final product (INTERP) , is back to the colors in which 
the frame was created. The second example is in TEXTEDIT, 
where the author must take care to select, for example, a 
light blue foreground without underlining and a dark blue 
foreground with underlining, in order to present a uniformly 
light blue foreground in the final product. Neither of 
these problems is monumental, both are correctable, but 
together they represent a constant irritant to the author, 
who is never quite sure what the graphics or text frame 
really looks like. The University of Utah Computer Science 
Department is aware of this problem and it will be corrected 
in subsequent versions of VCIS. 

Another color problem, which is a matter of taste rather 
than actual error, is the color selection in TEXTEDIT. Kith 
16 possible colors (on the IBM PC using the TECMAR Graphics 



70 



Master Color Board) , there are a number ox color combina- 
tions provided that are probably unusable. Many of the 
lighter colors (light blue and light green, for example) are 
not visible against other lighter colors. In addition, the 
author can visualize no usage whatsoever for a foreground 
and a background of the same color (the letters are not 
visible) . Again, the University of Utah programmers are 
aware of this and the color combinations will be rearranged 
to avoid the less usable combinations. 

E. LINKER 

The current version of LINKER generally performs as 
required. It links one control segment and up to eight 
called segments. However, the author encountered one 
totally unexplainable situation when the order of the called 
segments came into question. The order should not matter as 
LINKER should simply continue for the author-supplied list 
of segments until the next segment required by the control 
has been encountered. The author's actual and correct 
sequence of segments was, after the main control segment, an 
embedded menu with called segments, a normal segment, an 
embedded menu with called segments, and two more normal 
segments. LINKER continued to fail with errors indicating a 
problem within the normal segment located between the two 
embedded menus. The author relinked the menu segments, 
rebuilt the normal segment and reran LINKER without success. 
A University of Utah programmer suggested changing the order 
of the segments as given to LINKER which would not affect 
the final lesson order. The new order, which worked 
successf ully, was the two embedded menus, followed by the 
three normal segments. While changing the order was an easy 
solution to the problem, it was not necessarily obvious from 
the error messages received. 



F. NAMING CONVENTIONS 

BUILDER requires the use of both a segment name and a 
lesson name. It would seem reasonable to have one lesson 
name and possibly several segment names. A segment name and 
a lesson name must be the same, as the only name under which 
the file is stored is the outer or lesson name. Reuse of a 
lesson name, even with a different segment name results in 
destruction or change to the previous segment. LINKER also 
uses segment names rather than lesson names during the 
linking process. The documentation on VCIS does tell the 
author to use the same name for both segment and lesson, but 
it creates minor author confusion to have two different 
labels for the same name. 

G. MANAGER 

MANAGER provides many potentially useful lesson manage- 
ment conditions. It provides the ability to monitor student 
trouble spots by recording their paths through and responses 
to the lesson. Unfortunately, the program to read the 
student responses and paths is not yet available. If 
students make comments or continue to experience difficul- 
ties in the same areas, they must still contact the 
instructor as MANAGER, at present, has write-only 
capability . 

When the path or response recording function is used, 
the diskette obviously cannot be write-protected. While 
many students are responsible and probably would not delib- 
erately seek to destroy a lessen, the possiblitv for inad- 
vertent destruction exists. The student has the frustration 
of not knowing exactly what has occurred and must obtain new 
lesson diskettes from the instructor. Exactly this situ- 
ation occurred more than once with the UNIX tutorial. The 
author, therefore decided, that while recording student 
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paths and responses was a very useful lesson management 
concept, the concept was not yet ready for actual usage. 

H. OVERALL COMHEHTS 

The author found the VCIS authoring system to be a very 
effective means of producing a high quality product. The 
support rendered by the University of Utah staff was magnif- 
icent, with questions answered and solutions to problems 
provided almost instantaneously. 
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OTHER TUTORIALS AND ON-LINE HELP 



TO LOGIN/LOGOUT TO UNIX (ON ANY UNIX TERMINAL) 
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APPENDIX B 



SELECTED FRAMES FROM THE VLSI TUTORIAL 

Figures B. 1, B.2, 3.3, 3.4, and B.5 are intended to illus- 
trate seme of the graphics capabilities of the VCIS. These 
frames do not constitute the entire tutorial nor do they 
show all the graphics techniques available uiider VCIS. 




Figure B. 1 VLSI Tutorial Logo 



135 





Figure B.2 Summary of Basic Shapes, Colors, and Combinations 
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Figure B.3 



Butting Contact 
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Figure B.4 Review 
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Figure B. 5 



Mixed Notation 
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APPENDIX C 

SYSTEM REQUIREMENTS AND LCGON PROCEDURE FOR VCIS 

1 . Diskettes 

The IBM PC with VCIS uses double sided double 
density 5 1/4 inch floppy diskettes. TEXTEDIT, GRAFEDIT, 
and BUILDER each should have their own diskette due to their 
size. INTERP and MANAGER can reside on the same diskette. 
CHEDIT, LISTFRAM, and LINKER can also reside on the same 
floppy. 

2 . Logon Procedure 

A. Turn on the disk drive. The orange power switch is 
located to the right and near the back of the disk drive 
unit. Then turn on the monitor. 

B. The booting disk should he inserted label up in the 
leftmost or upper disk drive, also known as drive 0 or drive 
A. Where the location of drive 0 is, depends on the config- 
uration of the system. 

C. If the booting disk is not inserted before the IBM PC is 
turned on, depressing <CONTROL>, <DEL>, and <ALT> simultane- 
ously will boot the system. 

D. Rarely, booting the system does not clear the screen or 
produce the logon text. At this point, the user must turn 
the disk drive unit off for a few minutes and then re-boot. 

E. A successful booting will ask for the current date and 
the current time. If desired, they must be entered as in 
the sample on the screen. If no data or time needs to be 
attached to the session, typing <RET> twice cycles the user 
past this block. 
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F. The booting or system disk that comes with the Microsoft 
Dos 2.0 will not work with VCIS. VCIS restructures the 
keyboard in a certain manner, which is not done by the 
standard booting diskette. 

3 . loggin g Of f 

Provided that either the tutorial authoring session 
is complete, or that the tutorial execution is over, and the 
drive prompt has been displayed, the user may logoff simply 
by removing all diskettes and turning off the power switches 
previously mentioned. Removing the disks while the disk 
drive is moving is an emergency measure only and should be 
avoided if at all possible. 

4 . Executing The VItJ NIX Tu tori al 

A. Boot the system using the disk labelled "Tecmar booting 
disk". The prompt is "A>". 

B. Switch to b drive by typing "b:<RST>". 

C. Insert disk labelled "Viunix tutorial" or "VLSI Shapes 
tutorial" label up into right or lower drive. Type 
"viunix <RET>" or "shapes<RET>" , depending on which tutorial 
is being executed. There will be an initial flurry of 
colors/shapes. The tutorial is self-explanatory after this. 

D. If the user needs to leave the tutorial and is at a 
decision point {input is required the user), type <ESC>. 
The prompt is "Resume Stop ". Type only "S" (or "R" if the 
user has changed his/her mind) . Do not hit return - only 
the letter is necessary. 

E. Generally, if the user types in something very wrong, 
nothing should happen. The tutorial will wait at that 
screen until a correct response is entered. If the user 
inputs a misspelling that is at least 75* correct and suffi- 
ciently different from another correct response, the tuto- 
rial continues on what is assumed to be the correct path. 



For example, if the possible responses 
"NEXX" or "HEXT" will work, hut "HEXT" 
could be either "NEXT" or "HELP". A 
response must be 100% correct, cf course. 
F. logoff the PC using the procedure desc 



are "NEXT HELP", 
will not as that 
single character 



ribed previously. 



APPENDIX D 
SOBVEY ON TUTORIAL 



LIESEL 210TH 
TUTORIAL SURVEY 
12 OCTOBER 1534 



j. explan ation. 

THIS IS ONE IN A SERIES OF TUTORIALS ON VLSI DESIGN AND 
ASSOCIATED REQUIREMENTS. I WOULD LIKE YOUR 
SUGGESTIONS/PEELINGS/COMMENTS ON A VARIETY OF AREAS. 



2. TIMED FRAMES. 

THERE ARE SEVERAL FRAMES (USUALLY AT THE START OF A 
TUTORIAL) THAT ARE VISIBLE FOR A SET AMOUNT OF TIME. PLEASE 
COMMENT ON THE AMOUNT OF TIME - IS IT ENOUGH OR IS IT TOO 
MUCH TIME? WOULD IT HAVE BEEN BETTER TO HAVE BEEN ALLOWED 
TO CONTINUE WHEN READY RATHER TRAN HAVING A TIMED FRAME? 



2. MENU. 

IS THE USE OF THE MENU CLEAR? WOULD ANOTHER METHOD HAV 
BEEN BETTER OR LESS CONFUSING? IF YES, PLEASE EXPLAIN KHFR 
THE CONFUSION EXISTS AND WHAT COULD BE DONE TO IMPROVE IT. 
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3. USE OF COLORS IN TEXT . 

WERE ANY OF THE COLORS USEE IN THE TEXT IRRITATING OR 
UNNECESSARY? IF YES, PLEASE IDEDTIFY THE FRAME (S) AND 
EXPLAIN WHY. 



4. GRAP HIC S. 

AS NOT ALL THE TUTORIALS USE GRAPHICS, PLEASE SKIP THIS 
SECTION IF IT DOES NOT APPLY. 

WERE ANY OF THE GRAPHICS CONFUSING? IF YES, PLEASE 
IDENTIFY THE FRAME (S) AND EXPLAIN WHY. 



WERE THERE ANY FRAMES WHICH CONTAINED TOO MANY 
ILLUSTRATIONS? IF YES, PLEASE IDENTIFY THE FRAME (S) AND 
WHICH ILLUSTRATIONS SHOULD BE REMOVED. 
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5. SUMMARY FRAMES 



ARE THE SUMMARY FRAMES ADEQUATE? SHOULD THERE BE MORE OR 
LESS INFORMATION ON THEM? PLEASE IDENTIFY THE FRAME (S) AND 
STATE HON THEY COULD BE IMPROVED. 



6. DUAL S CRE EN PRESENTAT ION. 

DUAL SCREEN PRESENTATION IS NOT USED ON ALL TUTORIALS. 
PLEASE SKIP THIS SECTION IF IT DOES NOT APPLY. 

IS THE DUAL SCREEN PRESENTATION EFFECTIVE? WOULD IT HAVE 
BEEN BETTER TO HAVE USED ONLY ONE TERMINAL? 



7. STI PPL E PLOTS. 

STIPPLE PLOTS ARE NOT AVAILAELE ON ALL TUTORIALS. PLEASE 
SKIP THIS SECTION IF IT DOES NOT APPLY. 

DID YOU FIND THE STIPPLE PLOTS USEFUL/EFFECTIVE? WOULD 
YOU HAVE WANTED MORE OR FEWER PLOTS? 
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8. COM MENT S 

ARE THERE ANY OTHEE COMMENTS? AEE THERE ANY AREAS TO 
WHICH MATERIAL COOLD BE ADDED/DELETED? AEE THEEE ANY AREAS 
WHICH NEED IMPROVEMENT? PLEASE SPECIFY SECTION(S) AND 
FRAMES WHERE POSSIBLE. 



MANY THANKS FOR TAKING THE TIME TO DO THIS. 
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